# Delete a list

Permanently deletes a list and removes all user associations. Only the list owner can delete it.

Endpoint: DELETE /api/v1/lists/{listId}
Version: 1.0
Security: header

## Path parameters:

  - `listId` (string, required)
    ID of the list to delete. Must be a valid USER_LIST type TypeId.
    Example: "us_01hxcvk1hjexere4pvtrj0ymqq"

## Response 401 fields (application/json):

  - `errorCode` (string, required)
    Error code

  - `message` (string, required)
    Error message

  - `docUrl` (string)
    Link to documentation

## Response 403 fields (application/json):

  - `errorCode` (string, required)
    Error code

  - `message` (string, required)
    Error message

  - `docUrl` (string)
    Link to documentation

## Response 404 fields (application/json):

  - `errorCode` (string, required)
    Error code

  - `message` (string, required)
    Error message

  - `docUrl` (string)
    Link to documentation